Before you write to me with suggestions for the next version of Bolo, please read these frequently asked questions files, and read the "Bolo.futureplans" file to see if your suggestion is already on the list.
This file deals with frequently asked questions from Brain writers. It is compiled by Kovas Boguta <VISITOR@uicws.phy.uic.edu>
Ñ╩"What is the basic clock rate for Bolo?"
The basic "tick" in Bolo is 1/50th second.
Ñ╩"How is the firing for pillboxes controlled?"
A pillbox fires once every x ticks. For a quiescent pillbox x is 100 (two seconds). Each time it is hit, x halves, down to a minimum of 4 ticks (12.5 shots per second). x 'relaxes' back to the quiescent state at a rate of one unit every 32 ticks.
Pillboxes will shoot at you if you are within 8 map squares (2048 World units).
Pillbox shots go nine map squares (2304 World units).
Ñ╩"How is refuelling controlled?"
Refuelling bases refuel a tanks armour first, then shells, then mines. Armour is repaired at the rate of at most one unit per second. Shells and mines refuel at a rate of at most ten per second. (These rates may be lower in practice due to network delays.)
Every twenty seconds refuelling bases replenish their stocks by one unit per player in the game. For example, if there are five players in the game, then refuelling bases will replenish by five units every 20 seconds.
Ñ╩"What are the various maximum speeds of things in Bolo?"
The speed of a bullet is 32 World units per tick. The top speed of a tank on a boat is 16 World units per tick. Some other speeds are:
Terrain Tank speed Man speed
BUILDING 0 0
RIVER 3 0
SWAMP 3 4
CRATER 3 4
ROAD 16 16
FOREST 6 8
RUBBLE 3 4
GRASS 12 16
HALFBUILDING 0 0
BOAT 3 16
REFBASE/PILLBOX 16 16
Ñ╩"What example brain code is available and where can i get it, and what other
documents have information on writing brains?"
There is publicly available code of Indy 1.0, Standard Autopilot, Headset,
Ricklesbot, Decayed Brain. Also, there is the Bolo Brain Message Parsing
Library. Of these, only Indy and Standard Auto are full brains, while Headset
and Ricklesbot are `borgs. Decayed Brain only captures bases so it cant be
considered a full bot. Most of these can be found at the various bolo ftp sites.
Standard Autopilot is included in the Bolo package along with documentation on
how to write brains.
Ñ╩"Can you really only allocate 32K of memory from the heap? It seems Indy
2.02 allocates it out of Bolo's heap, instead of from Multifinder temporary
memory?"
No, there is not a limit. You do have to increase the Bolo Application
partition though. Both Ladmo and Indy allocate memory from the
Bolo Application heap. DK'd Brain, on which Ladmo is originally based,
took temporary memory from the system, through the use of temphandles.
I forget what version, but I changed Ladmo to take from the Bolo heap instead,
because of a couple of reasons: a bit easier to determine how much memory
is available, memory available is less likely to change, if it crashes
it takes down only Bolo and not the whole system.
Ñ╩"What starting information is passed to the brain? I couldn't find this,
but I remember something about bases only."
First look at the Brain.h. The BrainInfo is passed on every think call,
and in the Brain.h Stuart describes more on what is passed and when. When
starting a game it is just like any other time, you are passed what you own,
what you see and the location of the neutral bases.
Ñ╩"Is there a way to access the map information? If other players have
played/seen the map before, the brain should have the same advantage."
The only Brain I have seen that load in the map ahead of time is
"Will's Brain" by Will Uther which is not longer in production. Will
is now working with me on Ladmo. I don't know if Ladmo will have this
feature in a later version, we haven't discussed it yet. Anyway, Stuart
provides the structure of map files in the Bolo package. If you wanted
the option to load in the map you can add it.
Ñ╩"Is there a way to tell when a neutral, or hostile, pillbox has been
taken?"
Nope, and it is a bummer. The only way to tell is by seeing it happen or
seeing it gone later.
Ñ╩"Can a brain tell how many neutral bases remain?"
Yes, you get passed the location of all the neutral bases on each THINK
call. So you can of course count them up.
Ñ╩"Do bots have access to audio information?"
No.
Ñ╩"I notice that my brain sometimes crashes when control is transferred from
my brain back to Bolo. Is it possible that there are some memory operations
or writes to the info/message struct which may cause Bolo to crash?"
I originally though that I was overrunning my allocated memory,
or doing something inadvertently with memory allocated by way of NewPtr, but
am starting to doubt this.
Sounds like you are writing to somewhere you shouldn't be. I've had
problems with crashes when I call NewHandle (and not have enough memory).
I think this might be a fault with Bolo's Grow function (whatever it's
called) since it bombs if I request more memory than Bolo has been
allocated.
Also check to make sure that you are not modifying the Quickdraw Globals.
This could be a no no (Although changing the message text font is sometimes
interesting...)
Ñ╩"The crashes are usually accompanied by the (unhelpful) floating point
co-processor not installed (ID 25) system crash message."
This is probably a problem in your brain. By any chance you have some
floating point calls and 'Generate 68881 instructions' checked in Think C.
Ñ╩"Is it possible for messages sent in rapid succession (eg on successive
think calls) to become scrambled/lost/truncated during transmission? Also,
is it possible to send/recieve the full 0x01 to 0xFF character range,
or only a subset thereof? I have found messages containing compressed map
data to suffer from losses/scrambling every now and then even though the
decoding/encoding algorithms are compatible when run together in
another application."
YES. You really need to watch out for this. Once a message has been sent,
Bolo blanks out the sendmessage field (Data->sendmessage[0]==0). So just
check this before sending a new packet.
I think you can send characters from 0x01 to 0xff. However some characters
will look weird on the other player's end (Make sure you don't send the
